home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / ra / ieditv08.zip / ICEEDIT.DOC < prev    next >
Text File  |  1994-05-31  |  41KB  |  906 lines
  1.  
  2.  
  3. ─────────────────────────────────────────────────────────────────────────────
  4.  
  5.     ▄█▄   ▄███████▄  ▄█████████▄   ▄█████████▄ ▄████████▄   ▄█▄  ▄██████████▄
  6.    █████ ████▀  ▀███ ████    ▀▀▀   ████    ▀▀▀ ████   ▀███ █████ ▀▀▀▀████▀▀▀▀
  7.    █████ ████        ████▄▄▄▄▄     ████▄▄▄▄▄   ████    ███ █████     ████
  8.    █████ ████        ████▀▀▀▀▀     ████▀▀▀▀▀   ████    ███ █████     ████
  9.    █████ ████▄  ▄███ ████    ▄▄▄   ████    ▄▄▄ ████▄▄▄███▀ █████     ████
  10.     ▀█▀   ▀███████▀  ▀█████████▀   ▀█████████▀ ▀███████▀    ▀█▀      ▀██▀
  11.            ██   ██      ██   █▌       ██   █▌   █▌   ██               ██
  12.            ▐▌   ▐▌      ▐▌   ▐        ▐▌   ▐    ▐    ▐▌               ▐▌
  13.             ▌    ▌      ▐             ▐              ▐                 ▌
  14.  
  15. ─────────────────────────────────────────────────────────────────────────────
  16.      IceEdit v.80 -  CopyRight Jeremy Landvoigt, 1994  - IceEdit v0.80
  17. ─────────────────────────────────────────────────────────────────────────────
  18.  
  19.  
  20. ┌───────────────────────────────────────────────────────────────────────────┐ 
  21. │░░░▒▒▒▓▓▓          Some Unique Features Of IceEdit v0.80          ▓▓▓▒▒▒░░░│
  22. └───────────────────────────────────────────────────────────────────────────┘
  23.  
  24.  ∙ No extremely annoying unregistered taglines are ever appended to the end   
  25.    of messages like: "... This copy of ????? has been unregistered for 31     
  26.    days"
  27.  
  28.  ∙ IceEdit has a built in Macro replacement feature that will replace         
  29.    keywords with other words. Eg "RA" -> "RemoteAccess"
  30.  
  31.  ∙ IceEdit has a built message censoring feature to weed out inappropriate   
  32.    text. {+}
  33.  
  34.  ∙ Character Color Configuration for individual letters such as Uppercase,   
  35.    lowercase, High Bit, numbers, and punctuation.
  36.  
  37.  ∙ Random tagline appending feature. {+}
  38.  
  39.  ∙ Easy to use control keys.
  40.  
  41.  ∙ Color Code insert strings
  42.  
  43.  ∙ SysOp defined function key macros
  44.  
  45.  And MORE!
  46.  
  47.  
  48. ┌───────────────────────────────────────────────────────────────────────────┐ 
  49. │░░░▒▒▒▓▓▓          CopyRight Notices & Program Disclaimer         ▓▓▓▒▒▒░░░│ 
  50. └───────────────────────────────────────────────────────────────────────────┘
  51.  
  52.     The utility IceEdit, along with all its support files and documents,      
  53.     are Copyright (C) 1994 Jeremy Landvoigt.  Distributing a version
  54.     AFTER it has been registered is prohibited;  distribution & execution of  
  55.     the original, unaltered version is permitted, indeed encouraged, as long  
  56.     as all support-files and documentation that accompany the program are    
  57.     included WITHOUT ALTERATION OF ANY SORT.
  58.  
  59.     The author can be quickly reached for information through the RA_UTIL     
  60.     international FidoNET Conference.  If you wish to trust
  61.     comments/complaints/suggestions to the Post Office, you can send them to:
  62.  
  63.             Jeremy Landvoigt
  64.             100 Burling Place
  65.             Newmarket, Ontario
  66.             L3Y - 5W4
  67.             Canada
  68.  
  69.     The following programs mentioned in this documentation are Copyright of   
  70.     their respective authors. They are listed in no particular order:
  71.  
  72.     IceEdit      - CopyRight Jeremy Landvoigt
  73.     RemoteAccess - CopyRight Wantree Development & Andrew Milner
  74.     FKFossil     - CopyRight Tim Strike and Forbidden Knights Systems
  75.  
  76.     THE USUAL LEGALITIES
  77.  
  78.     I (Jeremy Landvoigt) make no warranty of any kind, expressed or implied,  
  79.     including without limitation any warranties of merchantability
  80.     and/or fitness for a particular purpose.  I shall not be held liable      
  81.     for any damages, whether direct, indirect, special or consequential       
  82.     arising from the failure of this program to operate in the manner desired 
  83.     by the user.  I shall not be held liable for any damage to data or        
  84.     property which may be caused directly or indirectly by the use of this    
  85.     program.
  86.  
  87.     In no event will I be held liable for any damages, including (but
  88.     not limited to) any lost profits, lost savings, or other incidental       
  89.     or consequential damages arising out of the use -- or the inability       
  90.     to use -- this program, or for any claim by any other party.  The only    
  91.     thing that IceEdit is guaranteed to do is to take up space on your        
  92.     hard drive.
  93.  
  94.  
  95.  
  96.  
  97. ┌───────────────────────────────────────────────────────────────────────────┐ 
  98. │░░░▒▒▒▓▓▓                         Credits                         ▓▓▓▒▒▒░░░│ 
  99. └───────────────────────────────────────────────────────────────────────────┘
  100.  
  101.    There are a few people who helped with the development of IceEdit that     
  102.    although they weren't involved in the creation or writing of the program,  
  103.    their suggestions, Bug reports, and lengthy ßeta testing have been an      
  104.    enormous asset. I would like to thank in no particular order :
  105.    Marc Kulak, Tommy Harvey, Jim Edwards, Eric Staufer, Mike Ehlert and
  106.    Steve Lanning for all of their help. Couldn't have done it without them!
  107.  
  108.    Also, portions of the Fossil Routines used in IceEdit v0.80 are Copyright
  109.    1993 By Tim Strike and Forbidden Knights Systems.
  110.  
  111.  
  112. ┌───────────────────────────────────────────────────────────────────────────┐ 
  113. │░░░▒▒▒▓▓▓                       Registration                      ▓▓▓▒▒▒░░░│ 
  114. └───────────────────────────────────────────────────────────────────────────┘
  115.  
  116.    The Development of IceEdit v0.80 took many long hours, and a lot of time
  117.    and effort not to mention money. This program is not FreeWare.  If this   
  118.    program satisfies your expectations of a fullscreen editor,if not MORE,    
  119.    then you are expected to register it after an evaluation period of 30 days
  120.    or sooner.  By doing this you can be sure of continued development of the  
  121.    software. Thanks for your support.
  122.  
  123.    This Program may be freely distributed but DO NOT under any circumstances  
  124.    change any of the executables or alter any files that come in the original 
  125.    distribution archive.
  126.  
  127.    I urge you to register as soon as you can! The more registrations that     
  128.    I have will show the interest of people in the program, and I will release 
  129.    a newer version with many more features. If you register, the Message
  130.    Censoring & tagline features will become available. All "Unregistered"
  131.    messages and almost inaudible beeps within the program will also be removed.
  132.    Please note that the status of features (whether they are available or not
  133.    to unregistered users) may be changed without further warning in later
  134.    versions of the software; but this does not mean that they will be
  135.    changed.
  136.  
  137.    If you wish to register, please fill out the registration form :
  138.  
  139.      Register.Can - Registration Form For Canadian Users
  140.      Register.Eur - United Kingdom & Other European Users
  141.      Register.Wld - For All Other Registrations
  142.  
  143.    Please at this time send ALL registrations to the address listed in the    
  144.    correct registration form. Thank you for your support.
  145.  
  146.    Any Registration forms that have invalid or missing information may be   
  147.    considered void and not be processed, depending on the extent of the       
  148.    errors.
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155. ┌───────────────────────────────────────────────────────────────────────────┐ 
  156. │░░░▒▒▒▓▓▓                      Archive Contents                   ▓▓▓▒▒▒░░░│ 
  157. └───────────────────────────────────────────────────────────────────────────┘
  158.  
  159.     The IceEdit archive should contain the following files :
  160.  
  161.     ICEEDIT.EXE         - The Main Program
  162.     EDITCFG.EXE         - Use to configure the program
  163.     070TO080.EXE        - v0.70 to v0.80 configuration converter
  164.     CENSOR.CFG          - Sample Censor keyword file
  165.     ICEEDIT.DOC         - Program Documentation
  166.     REGISTER.WLD        - Generic Registration Form
  167.     REGISTER.EUR        - UK/European Registration Form
  168.     REGISTER.CAN        - Canadian Registration Form
  169.     WHATSNEW.080        - Changes In IceEdit since previous versions
  170.     FILE_ID.DIZ         - General Program Description
  171.  
  172.     If one or any combination of these files are missing, or files have been  
  173.     ADDED, then you are using a possibly modified or altered copy of IceEdit. 
  174.     It would be advised that you delete this copy, and get a clean copy of    
  175.     IceEdit from one of the BBS's listed at the end of the documentation.    
  176.     Newest Version of IceEdit can be F'REQed from Ice Technologies BBS under  
  177.     the magic name 'ICEEDIT' (Without the quotes)
  178.  
  179.     Files IceEdit will create are :
  180.  
  181.     ICEEDIT.CFG         - The configuration file.
  182.     MACRO.CFG           - The file containing replacement macros.
  183.     MSGTMP.             - Textfile containing message text which is read in
  184.                           by RemoteAccess.
  185.  
  186.     Files IceEdit can/will read are :
  187.  
  188.     CONFIG.RA           - Read when IceEdit is first installed. It will
  189.                           attempt to determine if you are running RA by use
  190.                           of Environment variable, and if it can find the
  191.                           CONFIG.RA, it will read in some information from
  192.                           it.
  193.     MESSAGES.RA         - IceEdit will attempt to read this file if it can
  194.                           locate it by using the RA environment variable. It
  195.                           uses this file to determine whether or not a
  196.                           message area is an echomail/netmail base. If it is,
  197.                           the Color Code feature will be temporarily
  198.                           disabled.
  199.     DORINFO1.DEF        - Drop file containing user information.
  200.     MSGINF.             - File created by RemoteAccess containing message
  201.                           information such as Source User, Target User,
  202.                           message subject, & Message area.
  203.     MSGTMP.             - File created by RemoteAccess containing Quoted text.
  204.  
  205.  
  206. ┌───────────────────────────────────────────────────────────────────────────┐ 
  207. │░░░▒▒▒▓▓▓                   Program Information                   ▓▓▓▒▒▒░░░│ 
  208. └───────────────────────────────────────────────────────────────────────────┘
  209.  
  210.   IceEdit is a fullscreen ANSi message editor that was originally designed    
  211.   for use with RemoteAccess. Although it has only been tested with            
  212.   RemoteAccess v2.0x, it should be compatible with any other BBS that uses    
  213.   the QuickBBS style dropfiles that contain the message writing information.  
  214.   These files are MSGTMP & MSGINF. You should check your BBS documentation to
  215.   see if your software supports this system. IceEdit also calls on the
  216.   Dorinfo1.Def file to read in necessary information about the user profile.
  217.   IceEdit has a special feature specifically for RemoteAccess, which is
  218.   Echobase checking. Do not enable this feature if you are not using
  219.   RemoteAccess.
  220.  
  221.   Why was IceEdit created? .. Well, after I wrote my first major BBS utility, 
  222.   known as IceChat I was really surprised by the response to my chat program  
  223.   and the number of registrations that came in for it. When I first created
  224.   IceChat,  I never expected it to have the impact that it obviously had.
  225.   This encouraged  me to start writing other BBS (specifically RemoteAccess)
  226.   utilities. A number  suggestions came in for utilities such as a
  227.   UserEditor, a TimeBank, etc, but  the most challenging one was to write a
  228.   Fullscreen message editor, which I  thought would be a really great idea.
  229.   Not only for the challenge, but because  right now I feel that there are
  230.   very few message editors currently available,  and of the ones that do
  231.   exist, one or two of them tend to dominate the market,  and they STILL
  232.   didn't offer all the features that I would like to have in a  fullscreen
  233.   editor. Nevermind ridiculous registration fees. So, thus became the
  234.   beginnings of IceEdit.
  235.  
  236.  
  237. ┌───────────────────────────────────────────────────────────────────────────┐ 
  238. │░░░▒▒▒▓▓▓         Program Configuration -  Using EditCfg          ▓▓▓▒▒▒░░░│ 
  239. └───────────────────────────────────────────────────────────────────────────┘
  240.  
  241.    Setting up IceEdit is quite easy. This section of the documentation will   
  242.    attempt to take you step by step on how to use the configuration utility   
  243.    EditCfg.Exe to set up IceEdit. Most of the options are self explanatory.
  244.    You can use the local testmode feature at any time to test out how your
  245.    current settings will affect IceEdit.Exe without having to save your
  246.    settings or exit the configuration program.
  247.  
  248.    File
  249.    ------
  250.  
  251.    █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  252.    ▌  Save & Exit        ▐
  253.    ▌  Save Without Exit  ▐
  254.    ▌  Exit Without Save  ▐
  255.    ▌  Macro Editor       ▐
  256.    ▌  Registration Info  ▐
  257.    ▌  Program Info       ▐
  258.    ▌  Compile Taglines   ▐
  259.    ▌  Compile Dictionary ▐
  260.    ▌  Local Testmode     ▐
  261.    █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  262.  
  263.    · Save & Exit - This will save your current configuration to the
  264.      IceEdit.Cfg file and will exit the program.
  265.  
  266.    · Save Without Exit - This will save your current configuration to the     
  267.      IceEdit.Cfg file and will allow you to continue modifying your setup.
  268.  
  269.    · Exit Without Save - This will abort the save procedure (just in case you 
  270.      somehow really messed up!) and will exit the program.
  271.  
  272.    · Macro Editor - This will allow you to define replacement macros that     
  273.      will be used within IceEdit. For example, if you defined a macro such as 
  274.      "RA" -> "RemoteAccess", when the user types "RA" while editing their     
  275.      message, IceEdit will replace it with "RemoteAccess".  User Keywords are 
  276.      not case sensitive, so if the user was to type "RA" or "Ra" Or "rA" or   
  277.      "ra", each of these would still be replaced with "RemoteAccess". This    
  278.      function can be useful for correcting commonly misspelled words,
  279.      replacing shortforms, or "weeding out" inappropriate text (refer to     
  280.      message censoring function aswell).  The macrofile used in IceEdit is    
  281.      completely compatible with IceChat's macrofile, so you can interchange   
  282.      the macro files between both pieces of software.
  283.  
  284.    · Registration Info - This will simply display your current registration   
  285.      status, whether registered or unregistered.
  286.  
  287.    · Program Info - This will give you a little bit of information on the     
  288.      current version of IceEdit that you happen to be using.
  289.  
  290.    · Compile Taglines - Use this to compile taglines from text format
  291.      to encrypted datafile format that IceEdit can use. Once compiled,
  292.      the datafile cannot be edited unless you modify the original textfile
  293.      and recompile it. Although this might be an inconvenience, it will
  294.      speed up the random tagline selection process greatly, as it will not
  295.      be necessary for IceEdit to read the tagline file sequentially.
  296.  
  297.    · Compile Dictionary - Use this to compile a textfile with a list of
  298.      words to a encrypted private dictionary file. This feature is used to
  299.      add words to the dictionary database that you wouldn't usually find in
  300.      an average English dictionary, Such as "RemoteAccess", "FrontDoor" etc..
  301.      or any other slang terms that might be commonly used. Any words that
  302.      IceEdit finds in this file will not be treated as mis-spelled. Note,
  303.      the textfile that contains the words MUST not be the same name as what
  304.      the compiled file will be called. Eg, if you have 'ICEEDIT.PVT' as your
  305.      Private dictionary name, make sure you do not name the textfile with
  306.      this name before compilation.
  307.  
  308.  
  309.    · Local Testmode - You can use this at anytime during configuration to
  310.      view how your current configuration will affect IceEdit if you should
  311.      choose to save.  You can execute a local testmode from the dos prompt
  312.      by running IceEdit like this:  ICECHAT.EXE /L
  313.  
  314.  
  315.    Paths
  316.    -------
  317.  
  318.    █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  319.    ▌ Censoring File  ▐
  320.    ▌ Taglines File   ▐
  321.    ▌ Macro File      ▐
  322.    ▌ External Chat   ▐
  323.    ▌ Dictionary File ▐
  324.    █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  325.  
  326.    · Censoring File - This is a text file that you can create.  If the        
  327.      filename that you provide in this area exists, IceEdit will attempt to   
  328.      read in the file and scan the user's message for any matches of words    
  329.      within this file. If it finds any matches, it will strike out that     
  330.      particular word from the message. For example, if a censor word was     
  331.      "IDIOT", and the user had a sentence such as:
  332.  
  333.      "You are such an idiot!"
  334.  
  335.      After the scan was complete the word "IDIOT" would be stroked out and    
  336.      the result would be: "You are such an *****!".
  337.      A sample CENSOR.CFG file is included. The format is very simple; use     
  338.      one word per line. IceEdit is not case sensitive to the particular     
  339.      censoring word that is being compared.  Message censoring only takes     
  340.      place AFTER the user opts to save their message.
  341.  
  342.    · Taglines File - This file contains taglines that can be appended to      
  343.      the ending of the users message if they opt to save their text.
  344.      This is a textfile that you can create, although a sample is included    
  345.      called TagLines.Cfg. This file is encrypted, and MUST be compiled from
  346.      a textfile containing taglines. Use EditCfg to compile.  At this time
  347.      there is not any considerable limitation on the number of taglines that
  348.      the file may contain. However, the more that there are, the longer it
  349.      will take EditCfg to read in the textfile and convert it to a
  350.      structured datafile.
  351.  
  352.    · Macrofile - This is the name of the macrofile that IceEdit will make     
  353.      use of. It defaults to Macro.Cfg. Refer to FILE>MACRO_EDITOR for more    
  354.      information on macros.
  355.  
  356.    · External Chat - This is the full path and filename of your external chat 
  357.      utility. This can be executed from within IceEdit using the ALT-C key.
  358.  
  359.    · Dictionary File - This file contains words that are to be added to the
  360.      dictionary database when IceEdit is executed.  This file is encrypted,
  361.      and MUST be compiled from a textfile containing the words. Use EditCfg
  362.      to compile this file.  At this time there is not any considerable
  363.      limitation on the number of words that can be in the private dictionary
  364.      file. However, the more that there are, the longer it will take for
  365.      EditCfg to compile this file, and for IceEdit to search the file when
  366.      preforming a Spell Check.
  367.  
  368.    Toggles
  369.    ---------
  370.  
  371.    █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  372.    ▌ View Macros     YES ▐
  373.    ▌ Create Macros   NO  ▐
  374.    ▌ Tagline Prompt  YES ▐
  375.    ▌ Display Tagline NO  ▐
  376.    ▌ Censor Tagline  NO  ▐
  377.    ▌ Strike Symbol   [*] ▐
  378.    ▌ Imbedded Colors NO  ▐
  379.    ▌ Check EchoBase  NO  ▐
  380.    ▌ Confirm Abort   YES ▐
  381.    ▌ Use Quote Color YES ▐
  382.    ▌ Filter ANSi     NO  ▐
  383.    ▌ Imbedded Files  NO  ▐
  384.    ▌ Spell Checker   YES ▐
  385.    █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  386.  
  387.    
  388.  
  389.  
  390.    · View Macros YES/NO - Are users permitted to view the list of available   
  391.      macros from within IceEdit by using the CTRL-V key?
  392.  
  393.    · Create Macros YES/NO - Are users permitted to add to the list of
  394.      available macros from within IceEdit by using the CTRL-V key?
  395.      NOTE: View Macros MUST be enabled for this feature to work.
  396.  
  397.    · Tagline Prompt YES/NO - Should the user who is writing the message be    
  398.      prompted as to whether or not a tagline should be appended to the end    
  399.      of their message? If NO, the tagline will be AUTOMATICALLY appended     
  400.      unless the SysOP has not defined the filename of the tagline file.
  401.  
  402.    · Display Tagline YES/NO - Should IceEdit display to the user whatever
  403.      tagline it is that has been randomly selected from the tagline database?
  404.  
  405.    · Censor Tagline YES/NO - If the user uses inappropriate text in their     
  406.      message and IceEdit is forced to censor the text, should a tagline       
  407.      be appended to the message to inform future message readers of that     
  408.      fact?  Eg. "*** This message has been censored by IceEdit v0.80"
  409.  
  410.    · Strike Symbol [*] - What character should IceEdit use when striking out
  411.      text that can be found in the Censor.Cfg file. Asterisk ("*") is the
  412.      default.
  413.  
  414.    · Imbedded Colors YES/NO - Should imbedded color codes be permitted? If    
  415.      YES, when the message is saved, all color strings will be replaced by    
  416.      ANSi escape sequences, thus putting colors into the message. Refer     
  417.      below in "Editing Your Message In IceEdit" for more information on     
  418.      Color Strings.
  419.  
  420.    · Check EchoBase YES/NO - Should IceEdit attempt to determine whether
  421.      or not the message area being written to is an Echomail base. If it is,
  422.      Imbedded color codes will be disabled, as ANSi is not generally accepted
  423.      in network message areas. This feature is for *RemoteAccess* ONLY.
  424.  
  425.    · Confirm Abort YES/NO - Should IceEdit display a message to the user
  426.      if they choose to abort a message either by '/A', 'CTRL-A' or by use
  427.      of the help prompt which will ask them if they really want to abort their
  428.      message? Enabling this feature can help prevent accidental message
  429.      erasure.
  430.  
  431.    · Use Quote Color YES/NO - Should IceEdit use the quote color selected in
  432.      EditCfg to make quoted text a specific color. If NO, all quoted text will
  433.      have regular text coloration.
  434.  
  435.    · Filter ANSi YES/NO - Should IceEdit disrupt any ANSi that is read into
  436.      IceEdit whether it be quoted text or manually imported text by the SysOP?
  437.      If NO, all ANSi codes will be treated normally.
  438.  
  439.    · Imbedded Files YES/NO - Should IceEdit process imbedded file names. If
  440.      YES, IceEdit will read in the external file that is specified and add it
  441.      to the message text. Eg: If the user put the following string on a line
  442.      by itself ..
  443.  
  444.      %[MAIN.ANS]%
  445.  
  446.      If IceEdit can locate the file MAIN.ANS, it will import it into the
  447.      message text. Any files that you want to have imported MUST be surrounded
  448.      by the "%[" & "]%" brackets and should be placed on a single line without
  449.      any other text. You should specify the full path and filename of the file
  450.      to be imported. Please note, this function will PROPERLY import a file
  451.      into the message text, but editing before saving is not possible, as
  452.      all Imbedded files are processed when the user chooses to save.
  453.  
  454.    · Spell Checker YES/NO - Should users be permitted to make use of IceEdit's
  455.      built in spell checking routines? If YES, users can access the spell
  456.      checker from the status bar. Please note, the spell checker does take a
  457.      little time, as it must cross reference every word with the dictionary.
  458.      Also, words smaller than 3 letters will not be checked.
  459.  
  460.  
  461.    Colors
  462.    --------
  463.  
  464.    █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  465.    ▌ Txt.Punctuation  ▐
  466.    ▌ Txt.Numbers      ▐
  467.    ▌ Txt.UpperCase    ▐
  468.    ▌ Txt.LowerCase    ▐
  469.    ▌ Txt.High Bit     ▐
  470.    ▌ Txt.Quoted Text  ▐
  471.    ▌ Hdr.Hilite       ▐
  472.    ▌ Hdr.Lolite       ▐
  473.    ▌ Hdr.Text         ▐
  474.    ▌ Hdr.Time         ▐
  475.    ▌ Hdr.Punctuation  ▐
  476.    ▌ Hdr.Background   ▐
  477.    ▌ Punctuation      ▐
  478.    ▌ Numbers          ▐
  479.    ▌ UpperCase        ▐
  480.    ▌ LowerCase        ▐
  481.    ▌ High Bit         ▐
  482.    ▌ Default Settings ▐
  483.    █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  484.  
  485.    · This section on color configuration is self explanatory. Simply select   
  486.      the type of character which you wish to color configure. Another box     
  487.      will appear that will show you the list of available colors. Type in     
  488.      the number of the color you want to use.
  489.  
  490.    · TXT refers to all text that can be edited within the EDITING window.
  491.      (This includes Message Text, and Macro text that can be viewed using
  492.      CTRL-V)
  493.  
  494.    · HDR refers to the screen borders and all text WITHIN the upper header
  495.      area, as well as text that is in the Quote Window.
  496.  
  497.    · All remaining color configuration fields refer to regular strings and
  498.      prompts that are used within the program.
  499.  
  500.    · DEFAULT SETTINGS will restore all the colors to their original
  501.      installation settings.
  502.  
  503.  
  504.    Fn Macros
  505.    -----------
  506.  
  507.    █▀▀▀▀▀▀▀▀▀▀▀▀▀█
  508.    ▌  F1 Macro   ▐
  509.    ▌  F2 Macro   ▐
  510.    ▌  F3 Macro   ▐
  511.    ▌  F4 Macro   ▐
  512.    ▌  F5 Macro   ▐
  513.    ▌  F6 Macro   ▐
  514.    ▌  F7 Macro   ▐
  515.    ▌  F8 Macro   ▐
  516.    ▌  F9 Macro   ▐
  517.    ▌  F10 Macro  ▐
  518.    █▄▄▄▄▄▄▄▄▄▄▄▄▄█
  519.  
  520.    · This section is fairly simple.  You can define different Function keys   
  521.      (F1,F2..etc) to insert text into the message body while you are editing  
  522.      your message. This is useful for greetings, goodbyes, and signatures     
  523.      that are commonly used. For example, I might configure my Fn Keys like   
  524.      this :
  525.  
  526.      F1 - Take Care,
  527.      F2 - Later..
  528.      F3 - Jeremy
  529.      F4 - SysOP, Ice Technologies
  530.      F5 - .. Author Of IceChat.
  531.  
  532.      etc.. etc..
  533.  
  534.      If I hit one of my Fn Keys while in IceEdit, the appropriate text would  
  535.      be inserted at the current cursor position.
  536.  
  537.  
  538. ┌───────────────────────────────────────────────────────────────────────────┐ 
  539. │░░░▒▒▒▓▓▓         Setting Up IceEdit.Exe With RemoteAccess        ▓▓▓▒▒▒░░░│ 
  540. └───────────────────────────────────────────────────────────────────────────┘
  541.  
  542.   Please read the section of this document entitled 'Program Information -    
  543.   Using EditCfg' BEFORE attempting to install IceEdit into RA. Failure to     
  544.   setup  IceEdit correctly before installing it into your bbs program will    
  545.   probably  result in IceEdit failing to run or not running as expected.
  546.  
  547.   In order to run IceEdit.Exe with a user ONLINE, you must have a fossil      
  548.   driver  active. A fossil driver such as BNU should work fine with IceEdit.
  549.   If you  don't have a fossil driver installed, a simple error message will   
  550.   be displayed, and the program will stop. A fossil is NOT required when      
  551.   running  locally.
  552.  
  553.  **Note** : Do _NOT_ write protect _ANY_ Of the IceEdit files, if you do,     
  554.             IceEdit will ignore them, and therefore not run properly.
  555.  
  556.   We will now run through EVERYTHING you need to do in order to get IceEdit   
  557.   to  run in your RemoteAccess setup.
  558.  
  559.  
  560. 1.  Extract all the files in the distribution archive to a directory of your  
  561.     choice. C:\RA\ is recommended and is assumed to be the directory you are  
  562.     using from now on.
  563.  
  564. 2.  To help IceEdit find it's configuration files (if it is not being run     
  565.     from the current directory), you need to define an environment variable   
  566.     for it in this manner in your AutoExec.Bat :
  567.  
  568.     SET IEDIT={PATH TO ICEEDIT DIRECTORY}
  569.  
  570.     PLEASE NOTE, THE ENVIRONMENT VARIABLE NAME IS IEDIT  -  NOT ICEEDIT !!
  571.  
  572.     The environment variable is used by IceEdit to find its system files      
  573.     and configuration. Failure to setup the environment variable can result   
  574.     in IceEdit failing to run correctly - YOU HAVE BEEN WARNED!
  575.  
  576.     Please see your DOS manual for more information on environment variables.
  577.  
  578.   N.B.
  579.     You will need to reboot your machine after entering the environment       
  580.     variable for it to take effect.
  581.  
  582. 3.  Run EditCfg.Exe and configure all of IceEdit's options as explained       
  583.     earlier in this document. You MUST configure IceEdit for it to work       
  584.     correctly! Refer to the section of this document for setting up IceEdit.
  585.  
  586. 4.  IceEdit needs to be setup in RACONFIG.EXE so that when the user attempts  
  587.     to write a message it calls up IceEdit and NOT the internal RemoteAccess  
  588.     line-by-line editor. Change to your RemoteAccess directory and run        
  589.     RACONFIG.EXE. Go to OPTIONS>MESSAGES>EXTERNAL EDITOR. Place the command-  
  590.     line to run IceEdit.Exe in this space. Eg.
  591.  
  592.     C:\RA\IceEdit.Exe *M
  593.  
  594.     If you wish, you can specify the path to the dropfiles read in by IceEdit
  595.     (Dorinfo1.Def, MsgInf, and MsgTmp if it exists) by adding the following
  596.     parameter to your commandline like this:
  597.  
  598.     ICEEDIT.EXE /D:[PATH TO DROPFILES]
  599.  
  600.     Eg:   C:\RA\IceEdit.Exe /D:C:\RA
  601.  
  602.     Otherwise IceEdit will assume the dropfiles are located in the current
  603.     directory (usually your BBS directory)
  604.  
  605.     If you are PLANNING TO RUN ICEEDIT FROM YOUR NEWUSER.Q-A, then you should
  606.     use the following commandline in your RaConfig setup.
  607.  
  608.     C:\RA\ICEEDIT.EXE /B:*B /P:*P /T:*T *M
  609.  
  610.  
  611.  *B - Passes the baudrate out to the commandline.
  612.  
  613.  *P - Passes the modem port out to the commandline.
  614.  
  615.  *N - Passes the nodenumber as read from the %TASK% environment variable out
  616.       to the commandline.
  617.  
  618.  *M - Activate the MemorySwap feature.
  619.  
  620.  *T - Passes time limit out to the commandline.
  621.  
  622. 5.  When you run IceEdit, be sure that the IceEdit.Cfg file has been created. 
  623.     If it has not, then you MUST run EditCfg.Exe. If you don't, and attempt   
  624.     to run IceEdit.Exe directly, IceEdit will display an error message that   
  625.     IceEdit.Cfg doesn't exist.
  626.  
  627.  
  628. ┌───────────────────────────────────────────────────────────────────────────┐ 
  629. │░░░▒▒▒▓▓▓             Files That Are Used By IceEdit              ▓▓▓▒▒▒░░░│
  630. └───────────────────────────────────────────────────────────────────────────┘
  631.  
  632.  IceEdit will call upon a number of files during runtime. They are listed
  633.  below along with a brief description.
  634.  
  635.  CENSOR.CFG    - This is a textfile containing inappropriate words that
  636.                  IceEdit will strike out of the message text when they are
  637.                  encountered. {+}
  638.  
  639.  CONFIG.RA     - This file is read ONCE only by EDITCFG when you first install
  640.                  IceEdit. It will only be read if EditCfg can find the RA
  641.                  environment variable. It is compatible with the RA 2.0x
  642.                  Config.Ra file only. It will not read the Ra 1.1x format.
  643.  
  644.  COL_HELP.ANS  - This is an ANSi file that will be displayed that will replace
  645.                  the hardcoded colour help menu. You can create this with an
  646.                  ANSi editor such as TheDraw.
  647.  
  648.  DORINFO1.DEF  - This is the dropfile that most BBS packages can create that
  649.                  holds important user profile information.
  650.  
  651.  ICEEDIT.CFG   - This is IceEdit's configuration file. It is absolutely
  652.                  necessary in order for IceEdit.Exe to function.
  653.  
  654.  ICEEDIT.DIC   - This is the IceEdit dictionary that is used in conjunction
  655.                  with the spellcheck feature. It comes in a separate package
  656.                  from the main IceEdit program, due to its size.
  657.  
  658.  ICEEDIT.IDX   - This is the IceEdit dictionary index file that comes with
  659.                  the dictionary. It is also located in the secondary package.
  660.  
  661.  KEY_HELP.ANS  - This is an ANSi file that will be displayed that will replace
  662.                  the hardcoded Userkey help menu. You can create this with an
  663.                  ANSi editor such as TheDraw.
  664.  
  665.  MACRO.CFG     - This is the file that contains the replacement macros that
  666.                  can be used in IceEdit. It is compatible with the MACRO.CFG
  667.                  file that IceChat uses. This file must be edited using
  668.                  EDITCFG.EXE.
  669.  
  670.  MESSAGES.RA   - This file is scanned by IceEdit if you are using RA. If
  671.                  IceEdit determines that a particular message area is an
  672.                  ECHObase, it will disable the Color string feature (if you
  673.                  have configured it to do so)
  674.  
  675.  MSGINF.       - This file contains message writing information.
  676.  
  677.  MSGTMP.       - This file can contain both quoted message text as well as
  678.                  the regular message text that will be read back in by the
  679.                  BBS package.
  680.  
  681.  TAGLINES.CFG  - This is a tagline database that IceEdit will use to pick
  682.                  a random tagline to be appended to the end of messages. {+}
  683.  
  684.  
  685. ┌───────────────────────────────────────────────────────────────────────────┐ 
  686. │░░░▒▒▒▓▓▓           IceEdit.Exe Commandline Parameters            ▓▓▓▒▒▒░░░│
  687. └───────────────────────────────────────────────────────────────────────────┘
  688.  
  689.  Note: ALL Commandline parameters are optional, and do NOT have to be used
  690.  unless you are trying something new and different with IceEdit =). Generally
  691.  these parameters are only used with you are trying to run IceEdit without
  692.  a DORINFO1.DEF file (such as an offline mail reader)
  693.  
  694.     /B:[BAUD]     - Use this parameter to specify the baudrate.
  695.                     Eg.  ICEEDIT.EXE /B:14400
  696.  
  697.     /D:[PATH]     - Use this parameter to specify the path ONLY to the
  698.                     dropfiles that are to be used by IceEdit (DORINFO1.DEF,
  699.                     MSGTMP, MSGINF) Eg. ICEEDIT.EXE /D:C:\RA\LINE2
  700.  
  701.     /F:[FILENAME] - Use this parameter to change the default textfile that
  702.                     message text will be stored in. (Default = "MSGTMP")
  703.                     This is useful for offline mail readers.
  704.                     Eg. ICEEDIT.EXE /F:MSGTEMP.BBS
  705.  
  706.     /L            - Use this parameter to run IceEdit in local test mode.
  707.                     Eg. ICEEDIT.EXE /L
  708.  
  709.     /P:[COMPORT]  - Use this parameter to specify comport to be used by
  710.                     IceEdit. If you port is com3, then this is the
  711.                     commandline: ICEEDIT.EXE /P:3
  712.  
  713.     /T:[MINUTES]  - Use this parameter to specify the amount of time
  714.                     remaining for the user. Eg. ICEEDIT.EXE /T:30
  715.  
  716.     Please note: If you change any values above that correspond with values
  717.                  in the DORINFO1.DEF File, then the DORINFO1.DEF value will
  718.                  be overrided.
  719.  
  720.  
  721. ┌───────────────────────────────────────────────────────────────────────────┐ 
  722. │░░░▒▒▒▓▓▓             Editing your message in IceEdit             ▓▓▓▒▒▒░░░│ 
  723. └───────────────────────────────────────────────────────────────────────────┘
  724.  
  725.  Function Keys
  726.  ---------------
  727.  
  728.  To make message editing go easier, there are a number of different keys that 
  729.  may be used by both the SysOP and the user. A list follows:
  730.  
  731.  UP ARROW     - Moves the cursor up one line
  732.  DOWN ARROW   - Moves the cursor down one line
  733.  LEFT ARROW   - Moves the cursor to the left one space
  734.  RIGHT ARROW  - Moves the cursor to the right one space
  735.  INSERT       - Toggle the text insert/typeover mode
  736.  DELETE       - Delete the character currently under the cursor
  737.  
  738.  CTRL-A or /A - Abort message text & exit program
  739.  CTRL-C       - Center the current line of text on the screen
  740.  CTRL-D       - Move cursor to the right one space
  741.  CTRL-E       - Move cursor up one line
  742.  CTRL-J       - Left justify the current line of text on the screen
  743.  CTRL-L       - List / edit available macros
  744.  CTRL-P       - Place cursor at the end of the line
  745.  CTRL-Q or /Q - Quote window (Available only with message replies)
  746.  CTRL-R       - Redraw the editing screen
  747.  CTRL-S       - Move cursor to the left one space
  748.  CTRL-T       - Delete text from the cursor to the end of the line
  749.  CTRL-U       - Delete text from the cursor to the end of the current word
  750.  CTRL-V       - Toggle INSERT/TYPEOVER Modes
  751.  CTRL-W       - Return cursor to the beginning of the line
  752.  CTRL-X       - Move cursor down one line
  753.  CTRL-Y       - Erase current line of text
  754.  CTRL-Z or /S - Save message text & exit program
  755.  
  756.  There are also SysOP only keys that may be used:
  757.  
  758.  F1.. 10      - Activate previously defined SysOp text macros
  759.  ALT- F2      - Import a textfile into the message
  760.  ALT- F3      - Export message contents to a file
  761.  ALT- C       - Invoke external chat utility
  762.  ALT- H       - Terminate Connection
  763.  ALT- J       - Shell to DOS
  764.  ALT- =       - Add one minute to user's time
  765.  ALT- -       - Subtract one minute from user's time
  766.  
  767.  
  768.  Imbedded Replacement Strings
  769.  ------------------------------
  770.  
  771.  All replacement macros, taglines and SysOp function keys can make use of
  772.  the following built in control strings (NOTE ** Some are repeated to ensure
  773.  compatibility with ICECHAT replacement strings) :
  774.  
  775.   @A = SysOp name (Read From IceEdit Configuration)
  776.   @B = BBS name
  777.   @D = Date
  778.   @F = Receiving users first name
  779.   @R = Receiving users first name
  780.   @S = SysOp name (Read From IceEdit Configuration)
  781.   @T = Time of day
  782.   @U = Sending user's first name
  783.   @V = Program version number
  784.  
  785.  The control strings can be used in the following manner. For Example, if
  786.  you were configuring one of your macros to tell the current time & Date,
  787.  you could put:
  788.  
  789.   "MTD" -> "This message was written at @T on @D."
  790.  
  791.   And then when IceEdit is run, if the user chooses to type in the "MTD"
  792.   macro, the strings would be replaced and the result would be:
  793.  
  794.   "This message was written at 7:30p on 03/19/94."
  795.  
  796.  All the control strings can be used in a similar manner in all the other
  797.  macros & taglines, and Fn keys.
  798.  
  799.  Imbedded Colors
  800.  -----------------
  801.  
  802.  With IceEdit, it is possible to use color codes into your Message text.
  803.  This is very easily done. Wherever you would like to have a color change in  
  804.  your message, type one of the following codes:
  805.  
  806.    |01 - Blue
  807.    |02 - Green
  808.    |03 - Cyan
  809.    |04 - Red
  810.    |05 - Magenta
  811.    |06 - Brown
  812.    |07 - LightGray
  813.    |08 - DarkGray
  814.    |09 - LightBlue
  815.    |10 - LightGreen
  816.    |11 - LightCyan
  817.    |12 - LightRed
  818.    |13 - LightMagenta
  819.    |14 - Yellow
  820.    |15 - White
  821.  
  822.  So, If you had a line such as:
  823.  
  824.  "|15This is a |09test."
  825.  
  826.  The first three words "This is a" would be in White, and the rest, "Test."   
  827.  would be in LightBlue once the message has been saved.
  828.  
  829.  Please be aware of two important points. Firstly, IceEdit will NOT CHANGE    
  830.  the color WHILE YOU ARE EDITING the message.  Color strings will be          
  831.  converted  when the message is saved. Second, these codes are replaced with  
  832.  ANSi escape  sequences (the same codes that are used in your ANSi screens).  
  833.  
  834.  Many networks  do not authorize ANSi escape codes in their echos.  If you
  835.  are going to  make use of this feature, it is recommended that users are
  836.  informed on the  point that they should not use embedded color strings in
  837.  echomail areas. If you are using RemoteAccess, it is possible to make
  838.  IceEdit determine whether or not the message area is a local base. If it is
  839.  NOT, IceEdit can automatically temporarily disable Imbedded colors in the
  840.  message that the user is writing.
  841.  
  842.  Imbedded Files
  843.  ----------------
  844.  
  845.  With IceEdit, it is possible to have external filenames that will be later
  846.  imported into into your Message text. This is very easily done. Wherever
  847.  you would like to have a file imported into your message, use the following
  848.  method. For Example, say you have a textfile with some type of header in it
  849.  that you want to import into your message. The filename of the header is
  850.  BBSHDR.ASC for our example. In your message you would put the following on
  851.  a blank line of text:
  852.  
  853.  %[BBSHDR.ASC]%
  854.  
  855.  When your message is saved, IceEdit will seek out the filename between the
  856.  two special brackets ( %[ and ]% ). You can specify the path of the file
  857.  aswell, if the file is not located in your current directory, for example:
  858.  
  859.  %[C:\BBS\TXTFILES\BBSHDR.ASC]%
  860.  
  861.  When the message is saved, IceEdit will find this file, and import it into
  862.  the body of the message text, so your message might end up looking like
  863.  this:
  864.  
  865.           ▐██▌░▄█████▄ ▄██████░ ███████░▄██████░▄█████▄ ██░  ██░
  866.            ██░ ██░░░░░ ██▄▄▄▄░    ▐█▌░░░██▄▄▄▄░ ██░░░░░ ██▄▄▄██░
  867.            ██░ ██░     ██▀▀▀▀░    ▐█▌░  ██▀▀▀▀░ ██░     ██▀▀▀██░
  868.           ▐██▌░▀█████▀ ▀██████░   ▐█▌░  ▀██████░▀█████▀ ██░░░██░
  869.            ██░   ██░░░  ██░██░    ██░    ██░██░░  ██░░░ ██░  █▌░
  870.            ▐▌░   ▐▌░    ▐▌░▐▌░    ▐▌░    ▐▌░▐▌░   ▐▌░   ▐▌░  ▐░
  871.             ▌░   ▐░      ▌░       ▐░      ▌░      ▐░    ▐░
  872.  
  873.  
  874.  Please be aware of an important point. IceEdit will NOT IMPORT the file(s)
  875.  WHILE YOU ARE EDITING the message. File(s) will only be imported when the
  876.  message is saved.
  877.  
  878.  And that's all there is to it.. Hope you guys enjoy this thing, and it is
  879.  my hope that IceEdit becomes the default editor used with your system =-)
  880.  
  881.  
  882. ┌───────────────────────────────────────────────────────────────────────────┐ 
  883. │░░░▒▒▒▓▓▓            Program Support - BBS Locations              ▓▓▓▒▒▒░░░│ 
  884. └───────────────────────────────────────────────────────────────────────────┘
  885.  
  886.   IceEdit can be File Requested from any of the following BBS's under the     
  887.   magic name of ICEEDIT.  1200-14400 Baud Rates Supported.
  888.  
  889.   Legend
  890.   ──────
  891.  
  892.   S - Support Site   B - Beta Site   R - Registration Site D - Distrib. Site
  893.  
  894.   BBSName              Location  Phone           FidoNET     Flags
  895.   ──────────────────────────────────────────────────────────────────────────
  896.  
  897.   Ice Technologies     ON, CAN   (905) 895-0852  1:250/912   S B R D   14.4
  898.   Adventurer's Inn     SC, USA   (803) 552-6292  1:372/6577  S B   D   14.4
  899.   Blue iCE Beta Labs   TX, USA   (817) 596-5574  1:130/1016  S B   D   14.4
  900.   Concession Stand     FL, USA   (407) 569-6568  1:374/6568  S B   D   28.8
  901.   Crossed Wires BBS    NC, USA   (919) 580-7194  1:3660/809  S B   D   14.4
  902.   LightHouse BBS       IN, USA   (219) 922-9357  1:230/20    S B   D   14.4
  903.   Pacific Coast Micro  CA, USA   (805) 494-9386  1:102/1001  S B   D   14.4
  904.   Pacific Coast Micro  CA, USA   (805) 494-8427  1:102/1005  S B   D   14.4
  905.  
  906.